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RTK Bootcode 


Build Boot loader 

On-Chip Recovery mode 

Upgrade Boot loader 

Rescue System 

Dual Firmware Boot 

Customize kernel boot arguments 


Customize reserved memory for transcoding 


~ Build Boot loader RTD129x SPI 
U-Boot 
Path: SDKRelease/Bootcode/U-Boot64 
Build script: build.sh 
Usage: 
m ./build.sh RTD129x_spi 
Output: 
= Bootcode/U-Boot64/DVRBOOT_OUT/RTD129x_spi 
=m (1) Bootloader with burning program 
m S(CHIP_VER) RTD1295_hwsetting $(DDR)-nas-RTD1295_spi.bin 
m (2) HWsetting 
= hw_setting/S(CHIP_VER) RTD1295_hwsetting_BOOTS(DDR).bin 
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U-Boot 
Path: SDKRelease/Bootcode/U-Boot64 
Build script: build.sh 


Usage: 
m ./build.sh RTD129x_emmc 


Output: 
= Bootcode/U-Boot64/DVRBOOT _OUT/RTD129x_emmc 
=m (1) Bootloader with burning program 
m S(CHIP_VER) hwsetting $(DDR)-nas-S(CHIP)_spi.bin 
m (2) HWsetting 
m hw_setting/S(CHIP_VER) hwsetting BOOTS(DDR).bin 
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~ Build Boot loader — RTD1619 SPI 
= U-Boot 
m Path: SDKRelease/Bootcode/U-Boot64 
m Build script: build.sh 
=m Usage: ./build.sh RTD16xx_emmc 
m Output: 

= SDKRelease/Bootcode/U-Boot64/DVRBOOT_OUT/RTD16xx_emmc/ 

=m (1) Bootloader with burning program 

m AO1-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas-RTD16xx_emmce.bin 


m= (2) Bootloader 


m 1. A01-Recovery-uda-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
RTD16xx_emmc.bin 


m 2. A01-Recovery-boot-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
RTD16xx_emmc.bin 


m= (3) HWsetting 
=m hw_setting/0001-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
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Build Boot loader — RTD1619 eMMC 
m U-Boot 
m Path: SDKRelease/Bootcode/U-Boot64 
m Build script: build.sh 
=m Usage: ./build.sh RTD16xx_emmc 
m Output: 

= SDKRelease/Bootcode/U-Boot64/DVRBOOT_OUT/RTD16xx_emmc/ 

m= (1) Bootloader with burning program 

m AO1-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas-RTD16xx_emmce.bin 


m= (2) Bootloader 


m 1. A01-Recovery-uda-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
RTD16xx_emmc.bin 


m 2. A01-Recovery-boot-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
RTD16xx_emmc.bin 


m= (3) HWsetting 
=m hw_setting/0001-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
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Ctrl+q 


BOOT UP On-Chip Recovery Mode 


ESC 


Upgrade Boot loader 


USB/TFIP 


TAB =. 
Built-in Rescue system 
Boot into System 
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‘On-Chip Recovery mode — RTD 129x SPI 


This mode is used for bootloader recovery when the bootloader 
inside is corrupted 


= Hyperterm is recommended to use 


m Press ctril+qg when booting up until following console appear 


m d/g/r> 
Press h and then transfer Hwsetting(3) by y-modem 
=m hw_setting/S(CHIP) hwsetting BOOT _S(DDR).bin 
Press s, then enter 
m 98007058 
= 01500000 
Press d and then transfer bootloader(2) by y-modem 
m S(CHIP_VER) hwsetting BOOT_S(DDR)-nas-S(CHIP)_spi.bin 
Press g to start recovery process 
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-On-Chip Recovery mode — RTD129x eMMC 


=m This mode is used for bootloader recovery when the bootloader inside 
is corrupted 


Hyperterm is recommended to use 
=m Press ctri+q when booting up until following console appear 
m d/g/r> 
m= Press h and then transfer Hwsetting(3) by y-modem 
= hw_setting/S(CHIP) hwsetting BOOT S(DDR).bin 
m Press s, then enter 
m 98007058 
m 01500000 
= Press d and then transfer bootloader(2) by y-modem 
m S(CHIP_VER) hwsetting BOOT S(DDR)-nas-S(CHIP) emmce.bin 
Press g to start recovery process 
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“On-Chip Recovery mode — RTD 16xx SPI 


This mode is used for bootloader recovery when the bootloader 
inside is corrupted 


= Hyperterm is recommended to use 


m Press ctrl+q when booting up until following console appear 


= d/g/r> 
Press h and then transfer Hwsetting(3) by y-modem 
= hw_setting/0001-RTD161x_hwsetting BOOT _2DDR4 8Gb_s2666-nas- 
spi.bin 
Press d and then transfer bootloader(2) by y-modem 
m AO1-Recovery-RTD161x_hwsetting BOOT 2DDR4_8Gb_s2666-nas- 
spi.bin 
Press g to start recovery process 
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This mode is used for bootloader recovery when the bootloader inside 
is corrupted 


Hyperterm is recommended to use 

Press ctrl+q when booting up until following console appear 
m d/g/r> 

Press h and then transfer Hwsetting(3) by y-modem 


m hw_setting/0001-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
RTD16xx_emmc.bin 


Press d and then transfer bootloader(2) -1 by y-modem 


m A0O1-Recovery-uda-RTD161x_hwsetting BOOT _2DDR4_8Gb_s2666-nas- 
RTD16xx_emmc.bin 


Press g to start recovery process 


Press d and then transfer bootloader(2) -2 by y-modem 


m A0O1-Recovery-boot-RTD161x_hwsetting BOOT 2DDR4_8Gb_s2666-nas- 
RTD16xx_emmc.bin 


Press b1 to start recovery process 
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= This is for boot loader upgrade when current boot loader is 
workable 


m™ Press ESC when booting up to enter U-Boot console 
m Realtek> 


= Transfer bootloader with burning program(1) to DRAM 
m By USB 
= usb start 
= fatload usb 0:1 0x1500000 A01- 


RTD161x_hwsetting BOOT_2DDR4_8Gb_s2666-nas-RTD16xx_spi.bin or 
RTD161x_hwsetting BOOT_2DDR4_8Gb_s2666-nas-RTD16xx_emmc.bin 


=m go 0x1500000 
= Bytftp 
m tftp 0x1500000 AO1-RTD161x_hwsetting BOOT_2DDR4_8Gb_s2666-nas- 
RTD16xx_spi.bin or 
RTD161x_hwsetting BOOT_2DDR4_8Gb_s2666-nas-RTD16xx_emmc.bin 
m go 0x1500000 
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~ Rescue system 


m This is used to install install.img onto RTD129x/RTD1619 
m There are 2 ways to boot into rescue system 

m 1. use built-in rescue system 

m 2. use rescue system from USB or TFTP 


m= 1. For build-in rescue system, just press TAB when booting up, 
then the built-in rescue system is used 


= Once booting into rescue system, put install.img in USB top 
directory and plug into RTD129x/RTD1619, the install process 
will start automatically 
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m 2. For rescue system from USB or TFTP, we should copy 
following 3 files to USB or TFTP directory 


path: SDKRelease/OpenWRT-LEDE/target/linux/realtek/image/rtk- 
imagefile/workspace/rescue/ 


m 1. spi.ulmage 
m 2. rescue.spi.dtb 
m 3. rescue.root.spi.cpio.gz_pad.img 
= USB: press ESC into U-Boot console mode with USB attached 
and then press ‘gor’ 


= TFTP: press ESC and then input following command 


m tftp Skernel_loadaddr spi.ulmage;tftp Sfdt_loadaddr rescue.spi.dtb;tftp 
Srootfs_loadaddr rescue.root.spi.cpio.gz_pad.img;go k 


= put install.img in USB top directory and plug into 
RTD129x/RTD1619, the install process will start automatically 
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Waker! 


TFTP configuration 


= TFTP is configurable in boot loader console mode 


™ Press ESC into console mode and then edit tftp related 
environment variables 


Realtek> env set ipaddr 192.168.0.9 

Realtek> env set serverip 192.168.0.56 
Realtek> env set gatewayip 192.168.0.254 
Realtek> env set netmask 255.255.255.0 
Realtek> env save 

® ping command can be used to test network 
Realtek> ping 192.168.0.56 


Realtek Confidential 


eeté> REALTEK 
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Dual Firmware Boot 


#fw fwpart_name : actual _size(dec) [(hex)] Fa zone_size(dec) [ (hex) ] 
4-------------------- - 5 ee + 0x000001000000 
| FREE SPACE : 2719744 bytes [0x00298000] | 
4------------------- 5 ee + 0x000000d68000 
| 2ndfw linuxKernel : 3698688 bytes [0x00387000] / 4128768 bytes [0x003f0000] | 
| Image.lzma.padding | 
4--------------------------------------------------- == - = == == == = = 5 5 5 5 5 == + 0x000000978000 
| 2ndfw audiokernel : 311296 bytes [0x0004c000] / 393216 bytes [0x00060000] | 
| bluecore.audio.1zma.padding | 
+------------------------------------------------------ +--+ - +--+ = 5 5-5 5-5 5 5-5 + 0x000000918000 


| 2ndfiw rescueRootFs : 1048576 bytes [0x00100000] / 1048576 bytes [0x00100000] | 
| rescue _rootfs.cpio.gz.padding | 


9 a SS ee ee a See + 0x000000818000 
| 2ndfw rescueDT : 49152 bytes [0x0000c000] / 49152 bytes [0x0000c000] | 
| rescue.dtb.padding | 
a a + 0x00000080c000 
| 2ndfw kernelDT : 49152 bytes [0x0000c000] / 49152 bytes [0x0000c000] | 
| normal.dtb.padding | 
1 ee ee + 0x000000800000 
| FREE SPACE : 413696 bytes [0x00065000] | 
a ee + 0x00000079b000 
| lstfw linuxKernel : 3698688 bytes [0x00387000] / 4128768 bytes [0x003f0000] | 
| Image.1lzma.padding | 
SSS ee + 0x0000003ab000 
| ilstfw audioKernel : 311296 bytes [0x0004c000] / 393216 bytes [0x00060000] | 
| bluecore.audio.1zma.padding | 
$= a Se + 0x00000034b000 


| lstfw rescueRootFs : 1048576 bytes [0x00100000] / 1048576 bytes [0x00100000] | 
| rescue_rootfs.cpio.gz.padding | 


Sa a a aa a oo + 0x00000024b000 
| lstfiw rescueDT : 49152 bytes [0x0000c000] / 49152 bytes [0x0000c000] | 
| rescue.dtb.padding | 
SS + 0x00000023f000 
| 1lstfiw kernelDT : 49152 bytes [0x0000c000] / 49152 bytes [0x0000c000] | 
| normal.dtb.padding | 
ee ee ee + 0x000000233000 
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~ Dual Firmware Boot 


m There are 2 copies of firmware table and images (kernel, dtb, 
rescue rootfs...etc) installed in RTD129x/RTD1619 


™ Each firmware table has a sequence number (0-255) 


™ Boot loader will choose the latest (bigger) firmware table to 
bootup 


™ Once the latest firmware table or its content is corrupted, 
another firmware table will be chosen to bootup 
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Path: arch/arm/lib/bootm.c 
Function: set_custom_boot_args() 


m This function provides room to append programmable 
boot arguments. 


™ For example, the path of boot device might 
be "/dev/mmcblk0pO0" or "/dev/mmcblk0p1", depending on 
circumstances. This can be done by adding conditional 
statement in this function to control boot arguments. 

m™ The parameter "custom_boot_args" of this function is 
combined with kernelargs, and finally become part of kernel 
boot arguments. 
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Shutdown: Normal Shutdown 


AC Recovery: Enable/Disable 
WOL: Enable/Disable 


Power Cable Unplugged Power Cable Plugged 


S0/Normal Boot 
Normal/Force Shutdown Shutdown : 0 Power Cable Unplugged 


Shutdown : 1 


$5/Power Cable Plugged $5/Power Cable Unplugged 
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~ Customize Bootflow: AC-Recovery 
= Add Config 


= ./Bootcode/U-Boot64/configs/rtd161x_qa_nas_rtk_defconfig 
CONFIG_CUSTOMIZE_FEATURES=y 
CONFIG_CUSTOMIZE_BOOTFLOW_1=y 
CONFIG_CUSTOMIZE_BOOTFLOW_1_PHASE_1=y 


= ./Bootcode/U-Boot64/common/customized_bootflow_rtd161x.c 
#define PWR_KEY_IGPIO 2 (check you board before set) 
#define ACRECOVERY_PATH FACTORY_HEADER_FILE_.NAME"ACRECOVERY" 
#define POWER_STAT_PATH FACTORY_HEADER_FILE_NAME"SHUTDOWN" 
#define WAKE_ON_LAN_ PATH FACTORY_HEADER_FILE_.NAME"WAKEONLAN” 


=m ./rtd-1619-mmnas-megingjord-2GB.dts 
rtk_iso_gpio: rtk_iso_gpio@98007100 { 
wakeup-gpio-list = <&rtk_iso_gpio 2 0 1>; /*rtk_gpio gpio# direction value*/ 
/*direction: O=input, 1=output; when direction=O0=input, set value is useless */ 
wakeup-gpio-enable = <1>; /*O=disable, 1=enable*/ 
wakeup-gpio-activity = <0>;/*O=active low, 1=active high*/ 
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‘Customize Bootflow: AC-Recovery 


m Flag name: ACRECOVERY, SHUTDOWN, WAKEONLAN 
m User can set AC-recovery, Shutdown & WOL enable/disable by 
factory tool in user space. 
m Enable: factory flag flag-name 
m Disable: factory unflag flag-name 
= As flowchart, shutdown flag will be set to O(disable) in every 
normal boot. 
m When WOL is enable, be noted that WOL flag of gMAC also 
needs to set enable before shutdown. 
= echo 1 >/proc/net/ethO/r8169/wol_ enable 
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~ Customize reserved memory for transcoding 


= The following u-boot environment variables can be used to 
configure the reserved memory size for transcoding. 
Mm ion media heapQ size 


mM ion media heapl size 
m Usage 


m Set a positive integer for the size of ion media heap O or 1 (unit: MB) 
m If the value exceeds the max. allowable memory size, it will prompt error message 
and reset the heap size to default value when booting into kernel. 


Realee<> Gilw Geir LOW iileclie INSU sivas Loe 
NealoS< Gio, Sie 16 leclis Wesel sae aie 


m Set the size of ion media heap 0 & 1 to zero 
= Disable transcode 
m Free the reserved memory for transcoding 
m The board has to restart for this change to take effect. 


Neeilwe<> Gi Sig: 160 mecha Inoejol) Swe W 
Nesiloe <> Gi Sig won imeclle Inegjol sive 
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~ Customize reserved memory for transcoding 


m Usage 


m If the board is configured as pure NAS function (that is, 
there is no reserved memory for transcoding), attempting to 
set ion media heap0 sizeorion media heapl size will 


prompt error message and abort. 
Reeiloe< GN SiGe wer eclle nee ol! Gaze LU 
Weieone & Sly 26 WNSC Le! Ivesqo) SiwS US) 1 SSSie wee 1b e 


adjusting the memory size of ion media heap 
memreserve for ion media heap is not found. 


m™ To enable the transcode function again, delete the environment 


variable ion media heap0 size&ion media heapl size. 
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‘Customize reserved memory for transcoding 


oe - 


0x2FDOO000 
ION Media Heap 1 
0x16200000 


Ox0F900000 
ION Media Heap 0 


0x00100000 
0 


Memory Layout 
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